HONEYWELL 


DPS 7 

NETWORK 
ADMINISTRATION 
UTILITIES 
USER’S GUIDE 


SOFTWARE 


DPS 7 
NETWORK ADMINISTRATION 


UTILITIES 
USER’S GUIDE 


SUBJECT 


Use of the Principal Network Administration Utilities in a GCOS 7 
Environment 


SOFTWARE SUPPORTED 
GCOS 7 Release V1 


DOCUMENT NUMBER 
47 A2 10UC 


ORDER NUMBER 
10UC-00 August 1985 


Honeywell 


Attention Readers 


The GCOS 7 document set describes products and services available in many 
countries; some products described may not be available in every country. For 
example, the following products and product families are not available in the 
United States: 
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TERMINOLOGY 


| Certain terms used in GCOS 7 documents are not applicable to all DPS 7 

_ systems. To help you relate these terms to your DPS 7 system, the following 
equivalency list provides various interpretations for each of these terms. 
Familiarize yourself with these terms so you can apply them to your system if 
you encounter them in the documentation. 


Term(s) 

in Document Equivalent Term(s) 

DN7100, UNCP DN8, DATANET 8, or Front-end Network Processor 
(FNP) 

DSS -DPS6-DSA 

Mini 6 DPS6 

Mini 6/DSS DPS6-DSA 

MSC-E MSP4575, MSP4570 (on DPS 7), MSP4500, Integrated 
MSP on CPS4251 (on Level 64) 

MSC-RV | MSP4270 on DPS 7/E 
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MSU0500 MSU0555 (MS/M500)' 
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Term(s) 


in Document Equivalent Term(s) 

MTC-E MTP4270, MTP4275 (on DPS 7), MTP4200 (on Level 64) 
TTU8124 PRU1001/1003, TWU1001/1003 

TTU8126 PRU1005, TWU1005 

TTU8221 PRU1901, TWU1901 


DPS 2,DPS4,DPS6 DPS330 


OPERATING SYSTEM REFERENCES 


The following list shows operating system release equivalencies: 


Document 

Reference Operating System Release 

1D, 1D.n GCOS 64 Release 0400 

1E.0, 1E.1, 1E.2,1E.3 GCOS 64 Release 0500 

1E.4 (and up) GCOS 64 Release 0501 

1E GCOS 64 Release 0500 or 0501 (interchangeable) 
DOCUMENT ORDER NUMBERS 


The GCOS 7 software contains help messages that refer to GCOS 7 documents 
by eight-character document numbers (e.g., 47 A2 01UC, 47 A2 11UD). Use only 
the last four characters (e.g.,01UC, 11UD) to identify and/or order documents. A 
complete list of GCOS 7 documents can be found in the System Administrator’s 
Manual (01US), the IOF Terminal User’s Reference Manual: Part I(01UJ), and 
the GCOS 7 Software Release Bulletin (O1UG). 
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Preface 


This document describes the Network Administration Utilities in the GCOS 7 
environment. 


Section I gives a brief introduction. Section II describes the use of the Log File 
Editor. Section ITI describes the use of the Dump Editor. Appendix A provides an 
example of a Log File List. | 


REMARKS FORM 


Suggestions and criticisms concerning the form, content and purpose of this 
manual are invited. A Technical Publications Remarks Form is provided at the 
end of the Manual for this purpose. 


HEADING HIERARCHY 


Each section of this document is structured according to the heading hierarchy 
shown below. Each heading indicates the relative level of the text that follows it: 


Level Heading format | 

1 (highest) ALL CAPITAL LETTERS, UNDERLINED 

2 Initial Capital Letters, Underlined 

3 ALL CAPITAL LETTERS, NOT UNDERLINED 
4 Initial Capital Letters, Not Underlined 


5 (lowest) ALL CAPITAL LETTERS FOLLOWED BY COLON (:) 
Text begins on the same line. 


Section I 


Section II 


Section III 


Appendix A 


Table 2-1, 
Table 2-2, 
Table 2-3. 
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SECTION I 


INTRODUCTION 


‘GCOS provides editing utilities for the log and dump files used in the . 
context of the Distributed Systems Architecture (DSA). The affected 
systems, connectable to DPS 7 under DSA, include: : 

e Distributed System Satellite (DSS); i.e., Mini 6/DSS 

@ DATANET 7100. 

These systems will operate without changes to existing applications, but 
the GCOS 7 host operating system will require the presence of the Network 


Administration Utilities described in this document. 


The log file utility, described in Section 2, is applicable in connection 
with both DSS and DATANET 7100. 


The dump utility described in Section 3, however, is only applicable to 
the DATANET 7100. 
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SECTION II 


USE OF THE LOG FILE UTILITY 


INTRODUCTION 


The Log File Editor produces reports on all or part of the contents of 
the DSA log files stored on DPS7. The user may specify his report requi- 
rements through the Options File input. 


Options File 


BRIEF 

CLASS <item=class> 

FROM <date><time> 

LL <lLine=Length> 

LVL <minimum=priority~level> 

NN <site> Log File 
ORG <item=-origin> 

TO <date><t ime> 

TYPE <item-type> 


D1 
DSALOG Load module: 
utility H_FPPRJRNL 


Log file 
printout 


The Options File is optional and considered by the Log File Editor as a 
character string. It consists of a series of options, separated from each 
other by one or more space characters. There are two types of options: 

@ Formating options. 


@e Item selection options. 
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FORMATING OPTIONS 


BRIEF Indicates that only control data should be reported. 


Li 


Gives the effective Line length, which must be between 64 and 
132. The default value is 132. 


ITEM SELECTION OPTIONS (FILTERS) 


Each option can only appear once. If several options are selected, they 
are operated upon by a Logical ‘AND’. 


FROM Is used to enter the minimum date and time for selected log items 


NN 


TO 


TYPE 


to be included in the report. The values are entered in the 
YY:MM:DD and HH:MM:SS formats where the date and time entries are 
separated by one or more spaces. If no FROM option is specified, 
there is no ‘early Limit’ for inclusion of log entries in the 
report. 


Gives the network address of a specific site. This address is given 
in the format: 


area address: node address within the area. 


The two addresses are two-digit decimal numbers (for example 
01:13). If this option is present, only the log items whose 
‘responder node" correspond to this address will be included in 
the report. | 


Gives the latest time and date for which log items will be included 
in the report. The values are provided in YY:MM:DD and HH:MM:SS 
formats, where their date and time entries are separated by one or 
more spaces. The date is optional when a FROM option has been 
selected: in this case the default value for TO is the FROM date. 


Specific to a particular log item type which is to be reported on. 
The different types available are as follows: 


AC~CTL Administrative access rights check. 


AP=CTL Commands and replies relating to the-objects of an 
application : 


AP-INFO Solicited or unsolicited status or history information 
relating to the components of an application 


ND-CTL Commands and replies relating to the objects of a specific 
node 


ND“HIST Solicited or unsolicited history of the activity of an 
object of a specific node 


ND-STAT Solicited or unsolicited status information relating to 
the objects of a specific node 


NWeCTL § Commands and replies relating to the network node as such 
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CLASS 


LVL 


NW-ERR 
NWREVE 


NWeHIS 
NW=STA 


NW-TES 
NW-THR 
XN@CTL 


NOTE: 
CAEP). 


Unsolicited error message 
NT Unsolicited notification of an event 


T Solicited or unsolicited history of the activity of a net- 
work element 


T Solicited or unsolicited status information for a network 
element (generally, node status information) 


T Commands, replies and tests concerned with network testing 
SH Error threshold has been reached 
Control commands and replies for "cross net" operations 


The items conform to the Administrative Exchange Protocol 


Is used to enter a specific log item class. Only items belonging to 
the specified class will be included in the report. The different 
classes are as follows: 


Network administrator management 
Automevent management Cin a Node Administrator — NAD) 
Controller management 

Diagnostic application check 
Software debugging check 

Terminal management 

Executive 

Output filter management (in an NAD) 
Node start-up control 

Logical connection management 
Logical Line management 

Mailbox management 

Supplemental NAD check 

Node verification 

Network Operator Identity check 
Network connection management 
Network Administrator Storage Facility (NASF) check 
Packet management (Datagram) 

Package application check 

Physical Line management 

Error threshold reporting 


- Transport station management 


User application check 
Virtual circuit management 
Crossnet monitoring 
Crossnet transfers 


Is used to enter the minimum importance Level, below which the item 
will not be included in the report. The Level indicated must be an 
integer between 1 and 16 inclusive. The default value is 6. 
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~ 


ORG Is used for entering a specific type of origin for a log item: only 
Log items having this origin will be included in the report. The 
possible origins are as follows: 


AUTO 
CLCK 
EXEC 
NASF 
NCC 

OPER 
UMP 


XROM 


Network Administrator (NAD) automevent 


Time=base event in an NAD 


Node control program 

Network Administrator Storage Facility (NASF) 
Network Control Center 

Operator | 
Unsolicited event in a Network ADministrator (NAD) 


- Crossnet Load/Dump 


Option Decoding Error Messages 


UNKNOWN KEYWORD BAD LEVEL 

DUPLICATE KEYWORD NO VALUE FOR PARAMETER LEVEL 
LINE LENGTH MISSING BAD TYPE 

BAD LINE LENGTH NO VALUE FOR PARAMETER TYPE 
DATE/TIME (FROM) MISSING BAD CLASS 

BAD DATE/TIME NO VALUE FOR PARAMETER CLASS 
TIME (FROM) MISSING BAD ORIGIN 

BAD TIME CFROM) NO VALUE FOR PARAMETER ORIGIN 
DATE/TIME (TO) MISSING BAD SITE ID 

BAD DATE/TIME (TO) NO VALUE FOR PARAMETER NN 


PRINTER REPORTS 


The report as such is preceded by a listing of the options selected by 
the user. The presentation format for the standard log items depends on 
whether the BRIEF option has been requested. If the BRIEF option has been 
requested, one Line, which contains the control information, is printed 
for each Log item selected, 


If the BRIEF option has not been requested, a group of Lines is printed 
out for each log item: 


e The first Line gives the control information. 


e@ The second Line gives information concerning command parameters. 


@e The third Line (and subsequent lines, if required), gives information 
concerning the reply. 
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Format of the Control Information Line 


This line is 64 characters long and has a fixed format: 


Type of software (3 characters hexadecimal): 
@e Character 1: hardware type = 


Unknown 
DN 7100 
MINI 6 MOD 400/DSS 
DPS 7 host system 
DPS 8 host system. 


FWNM— © 


e Characters 2 and 3: software release number, 
Identification of responder node (5 characters): 


e Characters 1 & 2: Area address 


e Character 3: : 
e Characters 4 & 5: Node address within the area. 


Date and time (17 characters) format YY:MM:DD b HH:MM:SS 


Originator node identification (5 characters, same format as for the 
responder node) 


Type of origin (up to 4 characters, same format as for ORG in the 
options file) 


Origin (2 hexadecimal characters). The different possible values for 
ORG = are: | 


0 = NOI Connection of an operator 
1 = NCC Connection of an operator or a utility 
2 = XROM The number of the Link to the next node. 


Type (8 characters, same format as for the TYPE option) 
Class (4 characters, same format as for the CLASS option) 


Code (2 hexadecimal characters), indicating the specific action to be 
performed, or the number of the message sent. 


Reply format (2 hexadecimal characters), in a bit pattern which indi- 
cates the type of reply. If the bit is set, the meaning is as follows; 
bits | 


0 Rejected before processing 

1 Rejected during iteration 

4 Iteration not completed 

5 Rest of message to follow in another item. 


The priority level (2 hexadecimal characters, if the option LVL has 
been used). 
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Format of Command Data Line 


CMD==> CFROM = aaaal (TO = bbbb]I CSTATE = ceccl] Cxx.xxxxXe «ed 


Format of the Response Data 


The first 8 characters of the first Line contain the character string 
"RSP==>bb". The parameter values are printed out one after another, sepa~ 
rated by spaces. The keywords are not printed out (see - Interpretation 
of Response Line). 


INVOKING THE UTILITY 
Load module name: H_FPPRJRNL 


Option file characteristics: card file, internal file name: IN, optional, 
may be an input enclosure, may be parameterized. 


Log file characteristics: any file accessible in sequential mode and 
containing AEP records, maximum record length: 278 bytes, variable 
Length, internal file name: D1. 


Report file characteristics: sequential file, internal file name: OT. 
This file is generally redirected to the Output Writer with the JCL com 
mand SYSOUT. 


The name of the files used to store the log records is SYS.DSALOGN, where 
"n' is an integer value of from 1 through 9. For reasons of compatibility 
with previous releases, the Library SYS.FPJRNL may be used for storing 
Log records in members JRNL1 and JRNL2. 


The job stored could be the following: 
$JOB job—name USER = user-name; 
VALUES 13 
SSTEP H_FPPRJRNL SYS.HLMLIB DUMP = DATA; 
SASSIGN D1, SYS.DSAL0G&1; 
SSYSOUT OT; 
SENDSTEP; 
SENDJOB; 
ees Wheres 
job=-name Is the user-defined job name 


user=name Is the name applicable to the user concerned, as defined in the 
SITE.CATALOG. 


No options will be active for the editor, and all records will be listed 
in detail. It should be noted that the following standard jobs are loca 
ted in the Library SYS.HSLLIB: | 

@e DSALOG, for printing the log file's contents 


@ DSADUMP, for printing contents of the dump file. 
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Printing the log files may require some precautions, if these files are 
Concurrently used by the LOG ASF system. GCOS 7's Log ASF stores log re= 
cords in a set of 1 to 9 files managed in a circular way. It is therefore 
recommended that the user assign these files in the following manner: 


VL 13 
STEP ces 3 
ASSIGN D1, SYS.DSALOG&1, SHARE = ONEWRITE, ACCESS = READ; 


ENDSTEP; 


This also allows the contents of the currently active log file to be 
printed. 


In order to print Log ASF as soon as they are full, good practice is to 
use the automatic job spawning facility at Log ASF switching. At swit=- 
ching time, the DSALOG job (stored in the SYS.HSLLIB Library) is Launched 
automatically using the previous file name as a parameter; i.e., DSALOGI, 
if switching has occurred between the files SYS.DSALOGi and 
SYS.DSALOGi+1. 


Example of DSALOG JCL: 


STEP H_FPPRJRNL, SYS.HLMLIB, DUMP= DATA; 
ASSIGN D1, SYS.&1, «wee3 

— SYSOUT OT see} 
ENDSTEP; 


Note that, for reasons of compatibility with previous releases, the ASF 
LOG system also supports the SYS.FPJRNL Library's subfiles JRNL1 and 
JRNL2. For these, the ASSIGN should be in the following form: 


ASSIGN D1, SYS.FPJRNL, SUBFILE = JRNL&1; 


However, since any given subfile may not be read while being written to, 

the Log file utility may never be run on the subfile currently active. On 
the other hand, the log handler will be aborted if it attempts either to 

start on or to switch to a subfile already assigned in read mode (by the 

Log File utility). 


2-07 


Examples: Log File Editor Output | 


eee LOG FILE EDITOR version # date *** 80/09/24 11HH11MN44SS 
| xe PARAMETERS LIST *#® 
FROM 01:01:01 00:41:01 
TO 00:41:32 
wee NO ERROR DETECTED *** 
kee LOG FILE EDITOR VO03.00 80/09/01 *** 80/09/24 11HH11MN44SS 
wee LOG FILE LIST *** 


100 01:05 00:41:01 01:05 UMP OO NW-ERROR PL 01 00 10 
RSP==> HDC2 

100 01:05 00:41:01 01:05 UMP OO ND-HIST PL OD 00 OA 
RSP==> HD(2010200 | 

100 01:05 00:41:04 01:05 UMP OO NW-EVENT PL 02 00 OA 
RSP==> HDC2 

100 01:05 00:41:15 01:05 OPER 01 ND=STAT LL 03 08 02 
CMD== DA PL 


RSP==> HDL4 HDLC ENBL PL:HDC4 OFF 
| HDL2 HDLC ENBL PL:HDC2 OFF 
LLS1 SYN USED PL:PLS1 OFF 
LLS2 SYN ENBL PL:PLS2 OFF 
LLA1 ASY USED PL:PLA1 OFF 
LLA2 ASY ENBL PL:PLA2 OFF 
100 01:05 | 00:41:15 01:05 OPER 01 ND=STAT LL 03 08 02 
CMD==> DA PL | | 
RSP==> HDL4 HDLC ENBL PL:HDC4 OFF 
HDL2 HDLC ENBL PL:HDC2 OFF — 
LLS1 SYN USED PL:PLS1 OFF 
LLS2 SYN ENBL PL:PLS2 OFF 
LLA1 ASY USED PL:PLA1 OFF 
LLA2 ASY ENBL PL:PLA2 OFF 


100 01:05 00:41:16 01:05 UMP OO ND-HIST PL OD OO OA 
RSP==> PLAT 0 32 0 1344 00 

100 01:05 00:41:30 01:05 UMP OO NWeEVENT PL O17 00 OA 
RSP==> HDC2 

100 01:05 00:41:30 01:05 UMP OO NWERROR PL 01 00 10 
RSP==> HDC2 

100 01:05 00:41:31 01:05 UMP O00 NW-ERROR PL O01 00 10 
RSP==> HDC2 | 

100 01:05 00:41:32 01:05 UMP O00 ND-HIST PL OD OO OA 
RSP==> HDC2 010200 

READ = 000000164 


LISTED= 000000010 


eee Wheres 
DA Is the command for "Display Attributes" for the DN7100 
version # Is the release number of the utility 


date Is the date on which the utility was created. 


2-08 


INTERPRETATION OF THE RESPONSE LINE 


Appendix A gives information to assist in interpretation of the output 
from the Log File Editor utility, which consists of two types of page: 


@ A summary of the possible records within a set 


e A breakdown of each record indicated in the summary. 


Summary Sheets 


MESSAGE MANAGEMENT 


Logical Connection Open 
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HYPE 


The type of record corresponds to the meaning indicated in Table 2-1. 


Table 2-1. AEP Types 


Network test and debug operations 


Network controlling 


Network status 


Network history 
Node test and debug operations 


Node controlling 


Node status 
Node history 


Application controlling 


Application statistics 


Error reports 


Threshold warning reports 


Event announcements and reports 


Control of crossnet operations 


Administrative access rights control. 


Class 


The class of record corresponds to the meaning indicated in Table 2-2. 


Table 2-2. AEP Classes 


Crossnet monitoring 

Crossnet transfers 

Node start-up control 

Physical line management 

Logical Line management 

Network connection management 
Datagram packet management 
Virtual circuit management 
Transport Level 

Workstation management 

Mailbox management 

Logical connection management 
Controller management 

Terminal device management 
Administrative function management 
Software debug control 

Data storage management 

Time management 

Executive management 

Periodic response management (in NAD) 
Automevent management Cin NAD) 
Output filter management (in NAD) 
Threshold management 

Additional control of NAD itself 
Control of node 

NOI control 

NASF control 

NAUs control 

Diagnostic application control 
Packaged application control 
User application control 


O ONO URW 


Code 

The code applied to each message is a reference to the message within the 
set. This code is not necessarily unique within the set. 

Importance Level 


This is predetermined and is checked against the LVL parameter set in the 
AF command before being transmitted to the log file. ; 
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Breakdown Sheets 


The heading of each sheet contains the following information: 


FUNCTION: (e.g., MESSAGE MANAGEMENT) 
MESSAGE: (e.g., LOGICAL CONNECTION OPEN) 
TYPE The parameters of the message as 
Shown on the summary sheet and 
CLASS to be found in the control information 
Line of the printed output. 
CODE 
IMPORTANCE 
LEVEL 
MODE 3 (HEXA) (e.g.,J 08] 23 6838 6400) 


Each character indicates the 
format in which the respective 
“field is to be printed. 

See Table 2-3. 


This figure represents 
the (hexadecimal) 
number of fields in 
the response Line 


The body of each sheet contains a breakdown of the response for 


each message. 


FORMAT LENGTH PARAMETER 
(BYTES) 


Initiator flag = 0 : initiator 


ID of initiating node 
Significance of field. 


umber of bytes reserved for field ) 


Used by system to determine print 
format of field. d 


When the content of each record is printed the parameters are printed 
sequentially without keyword introductions. Missing parameters are 
replaced by a '*' character. These sheets indicate the order in which 
the parameters are printed. 
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Table 2-3. Log File Editor Print Formats 


] 


Defined field not present in response. 


2 byte character string. This string may contain numbers, 
Letters or blanks in either ASCII or EBCDIC codes. 


4 byte character string. This string may contain numbers, 
Letters or blanks in either ASCII or EBCDIC codes. 


16 bit unsigned integer. 

32 bit unsigned integer. 

16 bit hexadecimal value. 

32 bit hexadecimal value. 

32 bit date/time or period of time. Date/time is recorded as 
elapsed seconds since 1st January 1901 with a normal output 
format of: 


YY:MM:DD HH:MM:SS 


In the case of two outputs referring to the same pane the 
second PESeus format may be shortened to: 


HH: MM:SS 


This second format can also be used to express periods of 
time. 


Variable Length character string. The associated parameter 


field has the following format: 


<====HEADER----> | <---=CHARACTER STRING--- - ---> 
(16 bits) (variable) 


F= Code bit (0 = ASCII or 1 = EBCDIC) 
SIZE = Number of characters 


2715 


Table 2-3 (cont). Log File Editor Print Formats | 


Variable Length hexadecimal string. The associated parameter 
field has the following format: 


<==——HEADER=-———> | <=—-HEXADECIMAL BYTE STRING-=—- - --> 
| (16 bits) (variable) 


SIZE 


SIZE = Number of hexadecimal bytes 


16 bit object state value. The relationship between the | 
stored value and the output jis as follows: 


x§'100' =- SPAR ad | 
x'200" = DOWN | 
x'300' = DSBL 
x'400' =~ LOCK 
x*500' - TEST 
x'600' = ENBL 
x'700' = USED 


16 bit error status for item. The contents of the associated 
parameter is ignored if zero (good status) and the next field 
processed. If the contents of the associated parameter is not 
zero the current item is terminated and the value is output 
decimal with the prefix ERROR = 


Full object name. This is a 6 byte character string aligned 
a 16 bit word boundary. It will be output as the first 2 
characters, a colon and the remaining 4 characters. 


TBD 
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Table 2-3 (iii). Log File Editor Print Formats 


Variable Length decimal string defining a call number, a 
subcription number,... The associated parameter field has the 
following format: 


<HEADER> | < DECIMAL STRING-mo——-——- — ---—==> 
(8 bits) (variable) 
SIZE 
SIZE = number of 4 bit decimal characters in following 
string. 


Field Length = HEADER + CSIZE x 4] bits + CFILLER] 
FILLER = 0,4,8 or 12 bits to next 16 bit word boundary 


Escape to next 4 bit field and add 16 to value. There is no 
parameter field associated with this mode 3 field. 
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SECTION III 
USE OF THE DN 7100 DUMP UTILITY 


PURPOSE 


The dump editor is designed to print a DN 7100 memory image stored in a 
oPS7 file, giving a basic print out with a few options (specification of 
a range of addresses) and produces a hexadecimal interpretation as well 
as an ASCII and/or EBCDIC translation of the contents of memory. It does 
not provide an interpretation related to the DN 7100 software logic. 


FILES USED 
Three files are used, one of them being optional: 


1. The file containing the image to be printed, with the internal file 
name D1, must be accessible in standard sequential mode and is usually 
a direct subfile of the Library SYS.FPDUMP where the ADM system module 
stores dumps when taken (under the name fsys1 or fsys2, where "fsys"” 
is the name of the front-end system concerned). 


2. The optional file containing the particular options chosen for this 
treatment. If not present, all the default options will be applied. 
Its internal file name is IN, and it should be in card format. Only 
the first record if present will be analysed. This file could be an 
input enclosure, and the options may be parameterized with parameter 
values provided at job submission time. 


3. The report file, with the internal file name OT, is most commonly di- 
rected towards the Output Writer (with the JCL command SYSOUT). 


Dump Options 


ASCII 

EBCDIC dump file 
FROM <dump~address> SYS .FPDUMP 
LL <lLogical-Line=Length> 

TO <dump= address> 


dump editor 


Load module 
H_FPPRDUMP 


memory dump 
printout 


3-01 


REPORT PARAMETERS 

The options are read on IN file Cone cage only). 
The general format is either: 

@e keyword value 

@ keyword | 


At least one space is used as a separator, and is mandatory between a 
keyword and the associated value, or between one keyword and the next. 
The keywords can be presented in any order. There are default values for 
each option. 


1. FROM option 


This keyword must be followed by a string of up to 8 hexadecimal cha= 
racters (0 to 9, A to F). This string represents the address of the 
first word of DN 7100 memory (sixteen=bit words) to be included in the 
dump. The default value is 0. 


2. TO option 


This keyword must be followed by a string of 1 up to 8 hexadecimal 
characters © to 9, A to F). This string represents the address of the 
Last word of DN 7100 memory to be included in the dump. The default 
value is the maximum allowed: FFFFFFFF. 


3. ASCII option 


This is a keyword without an associated value. Its presence requests 
ASCII interpretation of memory content. Hexadecimal interpretation is 
always provided. If no specific interpretation is requested (neither 
ASCII, nor EBCDIC) ASCII interpretation is provided. 


4. EBCDIC option 


This is a keyword without an associated value. Its presence requests 
EBCDIC interpretation of memory contents. Hexadecimal interpretation 
is always provided. If both ASCII and EBCDIC are requested, both are 
provided; but a reduced number of addresses are consequently printed 
on each Line of output. 


ae LE 
This keyword enters the logical line Length to be used for the dump 


print out. It must be followed by a string of 2 to 3 decimal charac- 
ters representing the Logical length, in bytes, of the printed Line. 
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The general formats are as follows: 


ADDR ASCII 
12345678 1111 2222 3333 4444 gen 500 
L<est 


e 8 character field for location. The address is expressed as a right= 
justified hexadecimal value with blanks replacing leading zeroes. 


@ n groups of four hexadecimal characters, each group being separated. 
from the next by a space 


@e 2n characters representing the ASCII interpretation of the Line. 


-If onty EBCDIC interpretation is requested, the format is the same, but 
with provision, of course, of EBCDIC instead of ASCII interpretation. 


If both ASCII and EBCDIC options are specified, the format is: 


ADDR ASCII EBCDIC 
12345678 1111 2222 3333 4444 eo 33 DD ececcece 


1.e., address field: 
@® mn groups of 4 hexadecimal characters. 
@e 2n characters representing the ASCII interpretation 


e 2 n characters representing the EBCDIC interpretation. See Later in 
this manual for further explanations of the interpretations provided). 


Depending on the format used, the respective Lengths are either: 
e 12 + 5n+3 + 2n (iwe., 15 + 7n, if one interpretation) 
e 12 +5n+3 + 2n+4 + 2n Cice., 19 + On, if two interpretations) 


If it is chosen to print 1, 2, 4, 8 or 16 DN 7100 words on the same Line, 
the following array gives the thresholds applicable: 


neat ed tee 
is-one option | 22 | 29 | as | m1 | tar 
1f one option 43 v1 127 
LL | 
| is botn options | 26 | s7 | 55 | 9 | 


Then the parameter provided with the LL value will act upon the number of 
words printed on the same Line, with the program choosing a value in the 
array just less than the option. The value provided must be between 22 
and 132, with a default of 132 Ci.e., the maximum allowed). 


3-03 


Example of options: 

FROM A21F TO 3EC47 ASCII 
If no options are provided (iji.e., blank card on IN, or IN file empty, or 
IN file missing) the job will be the result of all the default options; 
that iss 


FROM 0 TO FFFFFFFF ASCII LL 132 


OPTION ANALYSIS AND ERROR MESSAGES 
1. Double occurrence of an option: 
If an option without an associated value (in ASCII or EBCDIC) is 
present twice, a warning message is issued and the option is taken in=~ 
to account. 
If an option with an associated value is present twice (FROM, TO, LL) 
a warning message is issued, and the next parameter is skipped 
(because it is suspected to be a value), and the first value 
associated with the keyword is used. 
2. Unrecognized keyword: 
An unrecognized keyword is skipped and a warning message is issued. 
For example a keyword not terminated by a space is not recognized, and 
the string is skipped until either a blank or the end of the card. 
3. Erroneous string for a value: 
An erroneous hexadecimal character (i.e., FROM or TO) or decimal 
character (i.e., LL) string is flagged and the whole value is ignored. 
4. List of error messages issued during option analysis: 
UNEXPECTED END OF OPTIONS 
SYNTAX ERROR UNKNOWN KEYWORD 
SECOND VALUE FOR PARAMETER FROM IGNORED 
SECOND VALUE FOR PARAMETER TO IGNORED 
SECOND VALUE FOR PARAMETER LL IGNORED 
TOO LONG STRING FOR LL VALUE OPTION IGNORED 
SECOND OCCURRENCE OF ASCII KEYWORD 


SECOND OCCURRENCE OF EBCDIC KEYWORD 
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TOO LONG VALUE 

TOO LONG KEYWORD 

VALUE IS NOT DECIMAL 

VALUE IS NOT HEXADECIMAL 

TOO SMALL VALUE FOR LL PARAMETER JOB ABANDONED 
TOO LARGE VALUE FOR LL PARAMETER, MAX ASSUMED 
NEITHER ASCII NOR EBCDIC OPTION,-ASCII ASSUMED 


OVERLAPPING BETWEEN TO AND FROM VALUES, JOB ABANDONED 


REPORT PRODUCTION 


Any file error occurring during processing except absence of the options 
file IN, is not handled by the program; this will lead to an abort (e.g., 
file code unknown, bad treatment mode, bad file organization or block 
Length). 


The file containing the DN 7100 memory image should be divided into 
Logical segments. These segments are consecutive, each containing a DN 
7100 address and a word count. The addresses in consecutive segments must 
be in ascending order. Therefore, if the user assigns a file which is not 
a DN 7100 memory image, or if the file was not properly created, the fol- 
Lowing message will be issued: 


OVERLAPPING OF DUMP SEGMENTS, JOB ABANDONED 


If the FROM option value is less than the first address in the file, or 
if a gap exists between two logical segments, the following Line is 
printed: 


ABCD ==== GAP ees where ABCD is the address requested. 


If two or more Lines are identical, only one is printed: 


EFO1 s=== SAME ee. where EFO1 is the starting address of the Last 
identical Line. 


‘- 


Running of the Job = The JCL Required for Batch Mode 


The utility is generally Launched directly on the files built by the ADM 
Dump modules. These files are subfiles of the SYS.FPDUMP Library. The ADM 
Dump modules keep track of 2 dumps per front-end processor connected; 
under the names fsys1 and fsys2, where "fsys"” is the name of the front 
end processor concerned. When a dump is taken, it is written to the ol- 
dest of the two subfiles applicable. 
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The internal file number D1 must be assigned to the chosen file. 


If the user wishes to override the default options, he should assign a 
card file to IN. The job could be the following: 


$JOB job name, USER = user_name; 

SSTEP H_FPPRDUMP, (SYS.HLMLIB)> 

SASSIGN D1, SYS.FPOUMP, SUBFILE = DN201; 
SSYSOUT OT; | 
SENDSTEP; 

SENDJ 0B; 


ane Where: 
job-name Is the user-defined job name 


user=name Is the name applicable to the user concerned, as defined in the 
SITE.CATALOG. 


The memory image stored in DN201 will then be printed with application 
of all the default options; i.e., printing of the whole file with ASCII 
interpretation. With his next job, the user might choose specific 
options: 


$JOB job name, USER = user name; 

SSTEP H_FPPRDUMP, (SYS.HLMLIB) >; 

SASSIGN D1, SYS.FPDUMP, SUBFILE = DN2O02; 
SSYSOUT OT; 

SASSIGN IN, * OPT; 

SENDSTEP; 

SINPUT OPT; 

FROM 2ACB ASCII TO 1FE43 EBCDIC 
SENDINPUT; 

SENDJOB; 


ee. Where the JOB statement parameters are as for the example at the top 
of this page. Here, the memory will be printed from address 2ACB through 
1FE43, with both ASCII and EBCDIC interpretations. 

Running of the Job by the System Operator 

The job may be catalogued in the Library SYS.HSLLIB, with the member 
name FPPRDUMP for example (i.e., the name under which. the job was 
stored). Then the job may be invoked by the system operator, with the GCL 
command EJR: 


EJR MEMBERS=FPPRDOUMP LIB=SYS.HSLLIB ; 


we. Either with the catalogued parameters, or with explicit values. 
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JCL Requirement Under IOF 


The user may catalogue a job with: 


Parameter values associated with name of the subfile and treatment 


options 


Choosing default options at storage time. At 
will be able to override these parameters. 


EXAMPLE 


The job catalogued might be: 


$JOB job name, USER = user name; 
SVALUES DN201, 0, FFFFFF, ‘ASCII EBCDIC'; 
SSTEP H_FPPRDUMP, (SYS.HLMLIB); 
SASSIGN D1, SYS.FPDUMP, SUBFILE = &1; 
$SYSOUT OT; 

SASSIGN IN, * PARAM: 

SENDSTEP? 

SINPUT PARAM, JVALUES; 

FROM &2 TO & &4 

SENDINPUT; 

SENDJ OB; 


ee. Where: 


job-name Is the user-defined job name 


job submission time, he 


user=-name Is the name applicable to the user concerned, as defined in the 


SITE.CATALOG. 


Then a submission without parameters will provide printing of the comple 
te subfile DN201 with both ASCII and EBCDIC interpretation. A submission 
with appropriate parameters, for example: 


EJR «., VALUES = (DN202, 10000, , EBCDIC), 


eee WiLL provide printing of subfile DN202 from address 10000 to the end 
but with EBCDIC interpretation only. 
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PRINTING OF SPECIAL CHARACTERS 


This section applies to ASCII and EBCDIC interpretations. The main rule 
is that numbers and letters are correctly printed. Lower-case letters, if 
any, are changed to upper case letters. Special characters approximately, 
.usually the same as is printed by the GCOS utilities. Hence: 


space CASCII 20, EBCDIC 40) 
quote - os (ASCII 22, EBCDIC 7F) 
number # CASCII 23, EBCDIC 7B) 
dollar $ (ASCII 24, EBCDIC 5B) 
percent % (ASCII 25, EBCDIC 6C) 
ampersand & (ASCII 26, EBCDIC 50) 
Left parenthesis ( (ASCII 28, EBCDIC 4D) 
right parenthesis ) (ASCII 29, EBCDIC 5D) 
asterisk * (ASCII 2A, EBCDIC 5C) 
plus + (ASCII 2B, EBCDIC 4E) 
comma 5 (ASCII 2C, EBCDIC 68) 
minus or hyphen - (ASCII 2D, EBCDIC 60) 
period 2 (ASCII 2E, EBCDIC 48) 
slash / (ASCII 2F, EBCDIC 61) 
colon : CASCII 3A, EBCDIC 7A) 
semicolon ; (ASCII 38, EBCDIC 5E) 
Less=than > < (ASCII 3C, EBCDIC 4C) 
equal to = (ASCII 30, EBCDIC 7E) 
greater than > (ASCII 3E, EBCDIC 66) 
9 


(ASCII 3F, EBCDIC 6F) 
(ASCII 5F, EBCDIC 6D) 


question mark | 
underscore 


eee Are correctly printed. However: 


is replaced by | 
(vertical bar) 

is replaced by ! 
apostrophe 

is replaced by 
Clogical not) 

is replaced by @a 
(commercial ‘at') 
(ASCII 7B, EBCDIC CO) 
(ASCII 7D, EBCDIC DO) 
(ASCII 58, EBCDIC 4A) 
(ASCII 5D, EBCDIC 5A) 
I 7E, EBCDIC A1) 


exclamation mark ! CASCII 21, EBCDIC 4F) 


acute accent , (ASCII 27, EBCDIC 7D) 


circumflex . CASCII 5&, EBCDIC 5F) 


grave accent : (ASCII 60, EBCDIC 79) 
opening brace ; 
closing brace 
Left bracket 
right bracket 
tilde 


are replaced by @ 
Ccommercial ‘at') 


Any current character which is not printable, is edited as a period "." 


3-08 


SP Space 
Quote grave accent 
Apostrophe, acute accent 
/ Slash 
! Exclamation mark 
7 Comma 
- Minus hyphen 


id » nt 


3-09 


‘- ig ne ae replaced by aa 
replaced by a™ 
(grave accent) replaced by a @ 


Circumf lex 
Underscore 
Opening brace 
Closing brace 
Vertical Line 
Tilde 


EBCDIC 


SP Space Underscore 
~ Minus : Apostrophe 


o , eae ree replaced by @ 
replaced by ™ 
: (grave accent) replaced by @ 
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APPENDIX A 
LOG FILE LIST EXAMPLE 


An explanation of the information in this appendix will be found in 
Section II. 


EXAMPLE LISTING 
*kk LOG FILE EDITOR VO3.00 80/09/01 *** = 83/01/20 O7HHSOMNO1SS 
eek LOG FILE LIST *#* 


013 01:34 01:01:02 04:18:51 01:34 UMP OO NWEVENT VC 04 00 06 
RSP==> DG6X XP68 1003 0900 


013 01:34 01:01:02 04:18:51 01:34 UMP OO NW-EVENT VC 01 00 06 
RSP==> DG6L DNLV 100A 00 0 00 C€420111101030122 


013 01:34 01:01:02 04:19:00 01:34 UMP OO NW-EVENT **** 01 00 06 
RSP==> 120 4 596 594 600 29752 30352 


013 01:34 01:01:02 04:19:02 01:34 UMP OO NW-EVENT vC 07 00 06 
RSP==> DNLV 1001 0 0 0090 


013 07:34 01:01:02 04:19:02 01:34 UMP O00 NW-EVENT vC 07 O00 06 
RSP==> DNLV 1001 0 0 0090 


(013 01:34 01:01:02 04:19:03 01:34 UMP OO NW-EVENT VC 07 00 06 
RSP==> DNLV 1001 0 0 0090 


013 01:34 01:01:02 04:19:18 01:34 UMP OO ND=HIST PL OD O00 OA 
RSP==> PLS4 0 140 14 0 0 


013 01:34 01:01:02 04:19:20 01:34 UMP OO ND-HIST PL OD O00 OA 
RSP==> 3900070700 


013 01:34 01:01:02 04:19:22 01:34 UMP OO ND-HIST PL OD OO OA 
RSP==> 3880070700 


013 01:34 01:01:02 04:19:24 01:34 UMP OO ND-HIST PL OD 00 OA 
RSP==> 3800 080800 : 


013 01:34 01:01:02 04:19:26 01:34 UMP OO ND-HIST PL OD O00 OA 
RSP==> 3180080800 


013 07:34 01:01:02 04:19:20 01:34 UMP OO ND-HIST PL OD O00 OA 
RSP==> 3900070700 


013 01:34 01:01:02 04:19:28 01:34 UMP OO ND-HIST PL OD 00 OA 
RSP==> 3100070700 


013 01:34 01:01:02 04:19:30 01:34 UMP OO ND-HIST PL OD 00 DA 
RSP==> 3080070700 
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RECORD EXPANSION LINE 17 


013 01:34 01:01:02 04:18:51 01:34 UMP OO NWEVENT VC 04 00 06 
RSP==> DGOX XP68 1003 0900 


QO 13 01:34 01:01:02 04: 18: 51 01:34 UMP Of) NW-EVENT VC 04 00 06 


| see below 
system=address 
address of 
areamaddress “originator” 
system 
time 
date 


system-address 
address of "responder" system 
area address 


software release 


hardware type 
~ unknown 
: DN7100 
Mini 6 MOD 400/Dss 
OPS 7 
DPS 8 


013 01:34 01:01:02 04:18:51 01 34 UMP OO] NWEVENT VC 04 


above ORG option CLASS 
option 
applicable to NCC, NOI and XROM | code 
NC: connection of operator or utility 
NOIsconnection of operator TYPE option 
XROM: number of Link to next system 


reply type (if set) 

bit 0: rejected before processing 
bit 1: rejected during iteration 

bit 4: iteration incomplete 

tagz rest of message in another item 


"priority"™/importance Level (LVL) 
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RECORD EXPANSION. LINE 2 


013 01:34 01:01:02 04:18:51 01:34 UMP OO NWeEVENT VC 01 00 06 
RSP==> DG6L DNLV 100A 00 0 00 €420111101030122 


RSP==> DG6L DNLV 10 OA 00 O OO C4 201111010350122 


data 
size of message 
facilities (16 bits) 
call address ( 8 bits) 
header size (16 bits) 
second byte ) 
) logical channel number 
first byte ) 
object=-name of subscriptor 


object=name of VC 
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